package com.qf.service;

import org.springframework.stereotype.Service;

import java.util.List;
import java.util.Optional;

/**
 * 招标信息联系人提取服务
 *
 * @since 9+
 */
public interface ContactExtractionService {

    /**
     * 从HTML内容中提取联系人信息
     *
     * @param htmlContent 招标信息的HTML内容
     * @return 提取到的联系人信息（如果存在）
     */
    Optional<String> extractContact(String htmlContent);

    /**
     * 添加自定义联系人匹配规则
     *
     * @param pattern 正则表达式模式
     */
    void addCustomPattern(String pattern);

    /**
     * 获取当前所有匹配规则
     *
     * @return 当前使用的正则表达式模式列表
     */
    List<String> getPatterns();

    /**
     * 重置为默认匹配规则
     */
    void resetToDefaultPatterns();
}